Passa al contenuto principale

Serialize

Metodo di oggettoMetodo di oggettoValore di ritornoStringa

Serializza un oggetto in formato JSON o XML.

warning

Da 31.1 è disponibile una seconda forma del metodo che restituisce una stringa contenente l'oggetto serializzato. In questa forma non va passata la variabile di tipo blob.

Definizione BC

È possibile utilizzare una delle seguenti sintassi per utilizzare il metodo:

Serialize(TIPO,RESULT,FL_SALVAERRORI)
Serialize(Type,WithErrors)
ParametroFormatoRiferimentoI/ODefaultVersione
TIPOEnumerazioneIN
TypeEnumerazioneIN
RESULTBlobOUT
WithErrorsInteroIN0
FL_SALVAERRORIInteroIN

Parametri

TIPO

EnumerazioneINInput

Indica il tipo di serializzazione da effettuare.

note

Se si sceglie il valore #XML, l'XML viene creato con encoding ISO-8859-1 e il contenuto del blob viene poi codificato in OEM (codifica standard del contenuto delle variabili BC).
Pertanto, se successivamente si vuole salvare il blob su file, è necessario convertire prima il testo in ANSI.

Parametro enumerato, può assumere i seguenti valori:

ValoreDescrizione
JSON
XML

Type

EnumerazioneINInput

Indica il tipo di serializzazione da effettuare.

note

Se si sceglie il valore #XML, l'XML viene creato con encoding ISO-8859-1 e il contenuto del blob viene poi codificato in OEM (codifica standard del contenuto delle variabili BC).
Pertanto, se successivamente si vuole salvare il blob su file, è necessario convertire prima il testo in ANSI.

Parametro enumerato, può assumere i seguenti valori:

ValoreDescrizione
JSON
XML

RESULT

BlobOUTOutput

Variabile di tipo blob in cui il metodo scrive il contenuto dell'oggetto o della collezione in formato JSON.

WithErrors

InteroINInput

Indica se serializzare anche gli eventuali errori impostati sull'oggetto.

Può essere un flag di tipo variabile o costante.

FL_SALVAERRORI

InteroINInput

Indica se serializzare anche gli eventuali errori impostati sull'oggetto.

Può essere un flag di tipo variabile o costante.

Esempi

Serializzazione dell'oggetto su una stringa

 DIM objSerializzato[STRING] = objArt.Serialize(#JSON, 1)    ' Serializzo il record

Serializzazione dell'oggetto su un blob

 DIM objSerializzato[BLOB]

objArt.Serialize(#JSON, objSerializzato, 1) ' Serializzo il record sul blob